APPENDIX A 


LAYOUTOBJECTS 

This entity lists all of the layout objects that 
can be used in a header, footer, segment, or grid. 
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<! ENTITY % HEADEROBJECTS 

"ACCUMULATOR | HEADERFIELD | AGGREGATE | LABEL | DELIMITER | RECTANGLE | IMAGE" > 
<! ENTITY % FOOTEROBJECTS 
10 "ACCUMULATOR | HEADERFIELD | AGGREGATE | LABEL | DELIMITER | RECTANGLE | IMAGE" > 
<! ENTITY % SEGMENTBODYOBJECTS 

"GRID | LABEL | ACCUMULATOR | AGGREGATE | HEADERFIELD | DELIMITER | RECTANGLE | IMAGE 

GRIDBODYOBJECTS " FIELD "> 
15 <! ENTITY % Left "left"> 

Center "center" > 
Right " right "> 
Money " money " > 

<! ENTITY % 

20 

Int "int"> 
String "string" > 
Date "date"> 
Numeric "numeric' 
25 <! ENTITY % Units "units "> 


ArgumentTypes; while only INT and string are supported herein, this is 
30 not intended to be limiting. 

- - > 

< ! ENTITY % ArgumentTypes " ( %Int ; | %String; ) " > 

<! ENTITY % True "true"> 

<! ENTITY % False "false"> 
35 < ! ENTITY % Boolean " (%True; | %False; ) " > 

<! ENTITY % Sum "sum"> 

<! ENTITY % Count " count "> 

<! ENTITY % First " first "> 

<! ENTITY % Last "last"> 
40 <! ENTITY % Min "min"> 

<! ENTITY % Max "max"> 

<! ENTITY % Average " average "> 

<! ENTITY % OperationValues 

" (%Sum; | %Count; | %First; | %Last; | %Min; | %Max; | %Average; ) "> 
45 <! ENTITY % Operation ' 

operation %OperationValues ; "%Sum; " 

' > 

<! ENTITY % FirstOrNewPage "firstnp"> 
< ! ENTITY % Always "always"> 
50 <i-- for First we "borrow" the same constant used for operations --> 
< ! ENTITY % DisplayRuleValues " (%First ; | %FirstOrNewPage ; | %Always ; ) " > 
< ! ENTITY % DisplayRule ' 

displayrule %DisplayRuleValues ; "%Always; " 

• > 

55 < ! ENTITY % Odd "odd"> 
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<! ENTITY % Even "even"> 
<! ENTITY % Any "any"> 

< ! ENTITY % PageS tartValues " (%Odd; | %Even; | %Any; ) " > 
<! ENTITY % PageStart 1 

pagestart %PageStart Values ; "%Any; " 

' > 

<! ENTITY % HtmlStream "HTML " > 

<! ENTITY % HpS t ream "PCL n > 

< ! ENTITY % AfpStream "AFP" > 

<! ENTITY % ScreenStream " SCREEN" > 

<! ENTITY % Pdf Stream "PDF"> 

<! ENTITY % StreamEnum 

" (%HtmlStream; | %HpStream; | %AfpStream; | %ScreenStreaCm; | %Pdf Stream; ) "> 
<! ENTITY % StreamAttr ' 

type ^StreamEnum; #REQUIRED 

' > 

<! ENTITY % Portrait "portrait "> 
<! ENTITY % Landscape " landscape "> 

< ! ENTITY % OrientationEnum " (%Portrait ; j %Landscape ; ) " > 
< I ENTITY % OrientationAttr 1 

orientation %OrientationEnum; "%Portrait; " 

1 > 

<!-- right now only zero or one stream (and it should be HTML) --> 
<! ENTITY % StreamElement " STREAM? "> 
< ! ENTITY % Identifier ' 

id ID #IMPLIED 

1 > 

<! ENTITY % Name ' 
name CDATA 
1 > 

<! ENTITY % Type » 

type %ExpressionTypes; "%ExpressionTypeDef ault ; " 
■ > 

<! ENTITY % Value ' 
value CDATA "" 
' > 

<! ENTITY % ArgumentType ' 

type % Argument Types ; "%Int;" 

1 > 
< ! -- 

x = horizontal placement of the item (from which alignment is 

derived) 

relativey = relative vertical displacement of the item from previous 
item 

y = absolute vertical displacement of the item 

height = height of the item 
width = width of the item's "bounding box" 
alignment = alignment of item within bounding box 

- - > 

<! ENTITY % Location 1 

X CDATA #REQUIRED 

relativey CDATA "0" 
y CDATA " 0 " 

height CDATA "1" 
width CDATA " 0 " 

alignment %AlignmentValues ; " %AlignmentDef ault ; " 
' > 
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< ! ENTITY % LocationZeroHeight ' 

x CDATA # REQUIRED 

relativey CDATA "0" 
y CDATA " 0 " 

5 height CDATA "0" 

width CDATA " 0 " 

alignment %AlignmentValues ; " %AlignmentDef ault ; " 
1 > 

< ! -- 

10 yadjust = yadj ustment parameter for fine-tuning positioning 

- -> 

<! ENTITY % YAdjust 1 

yadjust CDATA "0" 
■> 

15 <!-- 

leftmargin = left margin on page 

pagewidth = width of the page 

rightmargin = right margin on page 

topmargin = top margine on page 
20 pageheight = height of the page 

bottommargin= bottom margin on page 

- - > 

<! ENTITY % PageSettings * 

pagesize CDATA " " 

25 duplex CDATA "0" 

leftmargin CDATA "0" 

pagewidth CDATA #REQUIRED 

rightmargin CDATA "0" 

topmargin CDATA "0" 

30 pageheight CDATA # REQUIRED 

bottommargiri CDATA "0" 

•> 

< ! — 

visible = default visibility of the item 
■ - > 

< ! ENTITY % Visibility ' 

visible %Boolean; "%True;" 
1 > 

<! ENTITY % Floating ' 
40 floating %Boolean; "%False; n 

■ > 

< ! -- 

sortorder = order of this item relative to other items for sorting 
records 

45 sortascending = true if records will be sorted in ascending order on 

this item 

- - > 

<! ENTITY % Sorts ' 

sortorder CDATA "0" 

50 sortascending %Boolean; M %True;" 

»> 

<! ENTITY % Repeat 1 

repeat %Boolean; "%True; n 

■ > 

55 <! ENTITY % FormatString ' 
format CDATA " " 

■ > 
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<! ENTITY % ValueFormatString ' 
valformat CDATA 


"0" 
11 0" 


<! ENTITY % RequiredFormatString 
format CDATA # REQUIRED 

' > 

< 'ENTITY % Font ' 

font CDATA 
1 > 

<! ENTITY % Line 1 

line CDATA 
' > 

< ! ENTITY % Extents ' 
xextent CDATA 
y extent CDATA 
1 > 

< ! ENTITY % Shading 1 

shading CDATA "0" 

■ > 

< I ENTITY % NewPage * 

newpage %Boolean; "%False;" 

' > 

<! ENTITY % TextWrap 
wrap 

<l ENTITY % Exclude ' 
exclude 

• > 

<! ENTITY % Winpath ' 
winpath 
' > 

< ! ENTITY % Filename 
filename 

• > 

<!-- An example selection of encodings --> 

<! ENTITY % EncodeUTF8 "UTF-8"> 

<! ENTITY % EncodeUTF16 n UTF-16"> 

< ! ENTITY % EncodeIS088591 " ISO-885 9- 1 " > 

< ! ENTITY % EncodeEnum " ( %EncodeUTF8 ; | EncodeUTF16 ; | Encode IS08 85 91 ; ) 
<! ENTITY % EncodeAttr ' 
charset %EncodeEnum; #REQUIRED 
' > 

< ! - - 

LAYOUT 


%Boolean; 
%Boolean; 
CDATA 
CDATA 


"%False; " 
"%True; " 


Root -level element object. 

A layout is composed of segments. It optionally contains a 
description block. 


Attributes : 

dtdversion Version of the DTD on which this XML file is based 
version Version # of this layout specification 

- - > 

<! ELEMENT LAYOUT (DESCRIPTION?, METADATA?, NAME? , SEGMENT+) > 
< ! ATTLIST LAYOUT 

dtdversion CDATA #FIXED "19990827" 

%Name ; 
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version CDATA " " 

> 

< ! - - 

DESCRIPTION 

A description is a block that contains information about a layout 

- - > 

< I ELEMENT DESCRIPTION (TITLE? , AUTHOR?, MANAGER?, COMPANY?, COPYRIGHT? , 
COMMENTS ? , PROPERTY * ) > 
< ! ATTLIST DESCRIPTION 
%Identif ier ; 

> 

<! ELEMENT TITLE (# PCDATA) > 
< J ATTLIST TITLE 

%Identif ier / 

> 

<! ELEMENT AUTHOR (# PCDATA) > 
<! ATTLIST AUTHOR 

%Identif ier ; 

> 

< ! ELEMENT MANAGER ( # PCDATA) > 
<! ATTLIST MANAGER 
%Identif ier / 

> 

< ! ELEMENT COMPANY ( # PCDATA) > 
< ! ATTLIST COMPANY 
%Identifier; 

> 

<! ELEMENT COPYRIGHT (# PCDATA) > 
<! ATTLIST COPYRIGHT 
%Identifier; 

> 

<! ELEMENT COMMENTS (# PCDATA) > 
< ! ATTLIST COMMENTS 
%Identif ier / 

> 

<! ELEMENT PROPERTY (# PCDATA) > 
<! ATTLIST PROPERTY 

%Identif ier ; 

%Name ; 

> 

< ! -- 

METADATA 

Contains information about the generated invoice at the invoice 
level rather than the field or segment level. 

- - > 

< ! ELEMENT METADATA (DTD PATH? , ENCODING? ) > 
<! ELEMENT DTD PATH (# PCDATA) > 
<! ELEMENT ENCODING (# PCDATA ) > 
< ! ELEMENT NAME (# PCDATA) > 

< ! -- 

SEGMENT 

A section as an optional header and footer, which appear on each 
page of the invoice, an optional visibility filter, and any number of 
layout objects. 
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< ! ELEMENT SEGMENT (HEADER? , ( % SEGMENTBOD YOB JECTS ; ) * , FOOTER? , 
VISIBILITY? , %StreamE±ement ; ) > 
< ! ATTLIST SEGMENT 
5 %Identif ier; 

%Name ; 

%PageSettings ; 
%OrientationAttr; 
%PageStart; , 
10 %Visibility; 
> 

< ! — 

HEADER 

15 Header object for segments and grids. 

A header is a collection of layout objects. 

- - > 

< ! ELEMENT HEADER ( %HEADEROB JECTS ; ) * > 
< I ATTLIST HEADER 
20 %Identifier; 

^Visibility; 
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35 


40 


FOOTER 


Footer object for segments. 

A footer is a collection of layout objects. 

- - > 

< ! ELEMENT FOOTER ( %FOOTEROB JECTS ; ) * > 
30 <! ATTLIST FOOTER 

%Identif ier; 
%Visibility; 
%Floating; 

> 


< ! — 

DEL IMITER 


A delimiter is a line drawn between two points 


- > 

< ! ELEMENT DELIMITER (VISIBILITY? ) > 
<! ATTLIST DELIMITER 

%Identif ier; 

%Name ; 

45 %LocationZeroHeight ; 

%YAdjust; 

%Repeat ; 

%Visibility; 

%Line ; 
50 %Extents; 
> 

RECTANGLE 

55 A rectangle is a line drawn between two points 
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<! ELEMENT RECTANGLE (VISIBILITY? ) > 
< ! ATTLIST RECTANGLE 

%Identif ier ; 

%Name ; 

5 %LocationZeroHeight ; 

%YAdjust ; 
%Repeat ; 
%Visibility; 
%Line; 
10 %Shading; 

% Extents; 

> 

< ! -- 

IMAGE 

15 

A IMAGE is an object which will be rendered according 
to a graphics file. 

- - > 

<! ELEMENT IMAGE (VISIBILITY?, %StreamElement ; ) > 
20 <! ATTLIST IMAGE 

%Identif ier; 

%Name ; 

%Winpath; 

% Filename; 
25 %Exclude; 

%Location; 

%Repeat ; 

%Visibility; 

30 <!-- 

LABEL 

A label is a fixed value of a specific type. 

- - > 

35 <! ELEMENT LABEL (VISIBILITY?, %StreamElement ; ) > 
< ! ATTLIST LABEL 

%Identifier; 

%Name ; 

%Type; 
40 %Value; 

%Location; 

%FormatString; 

%Repeat ; 

% Va 1 ue Fo r ma t S t r i ng ; 
45 %Visibility; 
%Font; 
%TextWrap; 

> 

< ! - 

50 FIELD 

A field is a value of a specific type derived from an expression, 
with an optional applied visibility filter. 

- - > 

55 <! ELEMENT FIELD (EXPRESS I 0N+ , VISIBILITY?, %StreamElement ; ) > 
< ! ATTLIST FIELD 

%Identif ier; 
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%Name / 
%Location; 
%Font ; 

% Formats t ring ; 
%Sorts; 
%Visibility; 
%DisplayRule; 
%TextWrap ; 

> 

< ! -- 

HEADERFIELD 

A header field is a string value derived from a format string and 
zero or more expressions, with an optional applied visibility filter. 

- - > 

<! ELEMENT HEADERFIELD (EXPRESSION* , VISIBILITY?, %StreamElement ; ) > 
< ! ATTLIST HEADERFIELD 

%Identif ier ; 

%Name ; 

%Location; 

%Repeat ; 

%RequiredFormatString; 
%Font; 

%Visibility; 
%TextWrap; 

> 

< ! -- 

ACCUMULATOR 

An accumulator is a summation of an expression, with an optional 
applied visibility filter. 

An accumulator acts like a regular field, in that a single expression 
can generate 

multiple values, but for accumulators, only the final accumulation is 
displayed 

on the invoice; i.e., the individual expression values themselves are 
not displayed. 

- - > 

<! ELEMENT ACCUMULATOR (FILTER? , EXPRESSION, VISIBILITY?, 

%StreamElement ; ) > 

< ! ATTLIST ACCUMULATOR 

%Identif ier ; 

%Name ; 

%Location; 

%Operation; 

%Font ; 

%FormatString ; 
%Repeat ; 
%Visibility; 
%TextWrap; 

currency__f ormat CDATA " " 

> 

< ! 

AGGREGATE 

An aggregate is an aggregation of multiple instances of a single 
field or multiple fields, such 
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as the rows of a column in a grid. The aggregate specifies an 
operation to perform 

on the instances of the field, such as "sum" or "count." 

- - > 

5 <! ELEMENT AGGREGATE (FIELDREF+, VISIBILITY?, %StreamElement ; ) > 
< ! ATTLIST AGGREGATE 

%Identif ier ; 

%Name ; 

%Location; 
10 %Font; 

%FormatString; 

%Repeat ; 

%Visibility; 

%Operati on; 
15 %TextWrap; 

currency_f ormat CDATA " " 

> 

< ! -- 

FIELDREF 

20 

A field reference is the name of a field within this layout 
specification . 

- - > 

< I ELEMENT FIELDREF (# PCD ATA) > 
25 <! ATTLIST FIELDREF 
%Identif ier; 

> 

< ! -- 

GRID 

30 

A grid is a "table." It has a header and footer, and contains a 
grouping, 

one or more nested grids, or layout objects. A visibility filter can 

be 

35 applied to the grid. 

- - > 

<! ELEMENT GRID (FILTER?, HEADER?, (GROUPING | ( ( %GRIDBODYOB JECTS ; ) * ) | 
GRID+) , FOOTER?, VISIBILITY? ) > 
<! ATTLIST GRID 
40 %Identif ier; 

%Name ; 

%Location; 

%Visibility; 

%NewPage ; 

45 > 

< ! 

GROUPING . 

A GROUPING is a partition of a grid's rows. It has a header and 
50 footer, and 

contains either another GROUPING, or, at the most nested level, 
layout objects. 

Rows of a grid are placed into groups according to the GROUPING- 
FILTER 

55 for each GROUPING . The groups are then sorted according to the 

EXPRESSION. 

- - > 
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<! ELEMENT GROUPING (GROUPING- FILTER , EXPRESSION?, HEADER?, (GROUPING | 
( ( %GRIDBODYOB JECTS ; ) * ) | GRID+ ) , FOOTER? ) > 
< ! ATTLIST GROUPING 

%Identif ier ; 

%Name / 

%NewPage ; 

> 

< l -- 

EXPRESSION 

An expression is an evaluated function. Here, it is the name 
of the function to evaluate. 

Attributes : 

format = format identifier for the expression 

- - > 

<! ELEMENT EXPRESSION (# PCDATA) > 
< ! ATTLIST EXPRESSION 

%Identif ier ; 

%SortS; 

format CDATA 

> 

< ! -- 

VISIBILITY 

Visibility is a kind of filter. The data of VISIBILITY is the name 
of the function to call to determine whether an item should be 
displayed on the invoice or not. 

- - > 

<! ELEMENT VISIBILITY (# PCDATA | FILTERARGUMENT) *> 
<! ATTLIST VISIBILITY 
%Identif ier; 

> 

< ! -- 

STREAM 

Printer driver- specif ic stream for layout objects. The stream text 
is used as a format string for the layout object, i.e., inside the 
printer driver, if it supports streams, the value of an evaluated 
layout object is then plugged into the stream text and then sent 
to the output . 

- - > 

< ! ELEMENT STREAM (# PCDATA) > 
<! ATTLIST STREAM 

%StreamAttr ; 

> 

< ! 

FILTER 

A filter is an evaluated function. It specifies what rows will be 
used to create a view for a grid. 

- - > 

<! ELEMENT FILTER (# PCDATA | FILTERARGUMENT) *> 
<! ATTLIST FILTER 

%Identifier; 

> 

< ! ELEMENT FILTERARGUMENT (# PCDATA) > 
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< ! ATTLIST FILTERARGUMENT 
%ArgumentType ; 
%Value ; 

> 

5 <!-- 

GROUPING- FILTER 

A grouping filter is another kind of filter. It determines an 
exhaustive 

10 partition of the grid's view into subviews . 

- - > 

< 1 ELEMENT GROUPING -FILTER (# PCDATA) > 
< ! ATTLIST GROUPING- FILTER 
%Identif ier ; 

15 > 
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